docs: use discrete for background progress#9666
docs: use discrete for background progress#9666Rohan5commit wants to merge 1 commit intomicrosoft:mainfrom
Conversation
There was a problem hiding this comment.
Pull request overview
Updates the Status Bar UX guideline to use the correct term discrete (not discreet) when describing background progress, keeping the guidance accurate and consistent.
Changes:
- Replace “discreet” with “discrete” in the background progress guidance text.
- Replace “discreet” with “discrete” in the accompanying example caption.
| ### Progress Status Bar item | ||
|
|
||
| When needing to show discreet progress (progress happening in the background), it's recommended to show a Status Bar item with the loading icon (you can also add spin animation). If progress needs to be elevated for user attention, we recommend moving to a progress notification. | ||
| When needing to show discrete progress (progress happening in the background), it's recommended to show a Status Bar item with the loading icon (you can also add spin animation). If progress needs to be elevated for user attention, we recommend moving to a progress notification. |
There was a problem hiding this comment.
This sentence is hard to parse and is not in second person. Consider rewriting to a direct instruction (for example, start with "When you need to show..." and avoid "it's recommended").
| When needing to show discrete progress (progress happening in the background), it's recommended to show a Status Bar item with the loading icon (you can also add spin animation). If progress needs to be elevated for user attention, we recommend moving to a progress notification. | |
| When you need to show discrete progress, or progress that happens in the background, show a Status Bar item with the loading icon. You can also add a spin animation. If you need to elevate progress for user attention, move it to a progress notification. |
|  | ||
|
|
||
| *This example shows a progress Status Bar item that is discreet.* | ||
| *This example shows a progress Status Bar item that is discrete.* |
There was a problem hiding this comment.
The caption uses "discrete", which many readers confuse with "discreet". Consider rephrasing the caption to avoid the ambiguous word (for example, describe it as "background" progress) since the section already defines the concept.
| *This example shows a progress Status Bar item that is discrete.* | |
| *This example shows a progress Status Bar item that shows background progress.* |
|
@Rohan5commit In this instance, the use of "discreet" is appropriate as it refers to non-obtrusive as opposed to "separate". |
Summary
discretefor background progress wordingRelated issue
Guideline alignment
CONTRIBUTING.mdValidation
git diff --check